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CHAPTER I 

lNmooucTON 



MACRO-80 to a relocatable macro assembler for 0080 and Z80 
microcomputer systems. It assembles 8000 or Z80 code en any 8080 or 280 

development system running the CP/M, ISTS-II. TRSDOS or TEXDOS 
operating lyttem. The MACRO-80 package Includes the MACRO-80 
assembler, the LIhK-80 Unking loader, end the CREF-8Q crass reference 
facility. CP/M vers or* also include the L 16-00 Library Manager. 
MACRO-80 resides In approximately 1AK of memory end hae an assembly 
rate of over 1000 lines par minute. 

MACRO-80 Incorporates almost all "big computer 1 ' assembler features 
without sacrificing apace* a- memory space. The assembler supports a 
complete, Intel standard macro facility, Including JFP, IRPC, REP£AT, 
local variables and EXITM. Nesting of macros is limited only by memory* 

Code Is assembled In relocatebie modules that are manipulated with the 

flexible Unking loader. Condltlonel assembly capability Is enhanced by an 
expanded set of conditional pseudo operations that Include tasting of 

assembly peas, symbol definition, end parameters to macros. Conditionals 

may be nested up to 255 levels. 

MACRO-80*s OnMng loader provides a versatile array of loader capabilities, 
which are executed by means of easy command lines and twitches. Any 
number of programs may be loaded with one command, relocatable modules 
may be loaded in user-specified locations, and external references between 
modules ere resolved automatically by the loader- The loader also per fo rm s 
library searches for system subroutines and generates a load map of memory 
showing the locations of the main program and subroutine*. The cro ss 

reference facility that la included in this package supplies a convenient 
alphabetic list of all program variable names, along with the Una numbers 
where they ere r e f ere n ced and defined. 

This manual is designed to serve a* a reference guide to the MACRO-80 
package. It defines, explains and gives example* of all tna features in 
MACRO-80 in terms that should be understandable to anyone familiar with 
assembly language programming. It is not Intended, how e ver, to serve as 
Instructional material and presumes the uaar has substantial knowledge of 
essembly language programming. The uaar should refer to Instructional 
material available from a variety of source* for additional tutorial 
Information. 



Utility Software Manual 



CHAPTER 2 
MACRO-30 ASSEMBLER 



2.1 RUNNING MACRO- 80 

r-« command tc run MACRC-60 is 

M£C 
MACRG-80 returns the prompt "**\ indicating It is ready to accept commands, 

NOTE 

If ycu are using the TEXOOS operating system, 

see Aqpendix A for proper command formats. 



2.2 COMMAND FORMAT 

A command tc MACRG-8C consists cf a string of filenames with coticrai 
switches. AU filenames should foilcw the operating system's conventions for 
fiienames one extensions. The default extensions sucolied by Microsoft scft-sre 
are as fOiicws; 

File CP/M ISIS-g 

Rciccatooie object file REL REL 

L.sting f ! .;e PRN LST 

MACRC-nC source file MAC MAC 

FC"".AN source file FCR FCR 

CCECL Murce CCS CC6 

BASIC source 8AS 6AS 

Absofute file CCM 

A command to MACRC-60 conveys the name of the source file to be assembled, 
tre names of the flievi) to be created, and which assembly options are desired- 
The format of a MACRC-30 command is: 

oojfile T l3tfile=source file 

Only the equal sign and the source file field are required to create a relocatable 
object file with the default tsource) filename and the default extension REL. 

Otherwise, an cbiect file is created only if the objfile field is filled, and a ;:st:ng 
fiie -js created cnly if the Istfile fieid is filled. 
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To assemble the source file without producing an object file or listing file, place 
only a comma to the left of Che equal sign. This is a handy procedure that lata 
you check for syntax errors before assembling to an object file. 

examples: 

*»TEST Assemble the source file TEST.MAC and place the 

object file In TEST.REL without a listing file. 

♦,-TCST Assemble the source Hie TEST.MAC without 

creating an abject ar listing file. Useful far error 
checking. 

TEST/TEST.TEST Assemble the source file TEST.MAC, placing the 

object file in TEST-REL and the listing file in 
TEST.PRN. QMth IS1S-D, the listing rile is TEST.LST.) 

•C8JECT-TES7 Assemble the source file TEST.MAC and place the 

object file In OBJECT .REL. 

OBJECT 4-IST»TEST Assemble the source file TEST.MAC T placing the 

object file In OB^ECT.REL and the listing file in 
UST.PRN. OMth 1SIS-II, trie listing file is UST.LST.) 

MACRO- 80 also supports command lines; that ia# the invocation and command 
may be typed on the same line. For example: 

M80 ,-TEST 



2.2-1 C* vices 

Any field in the MACRO-80 command string can also specify a device name. 
The cefault device name with the CP/M operating system is the currently logged 
disk. The default device name with the ISlS-D operating system is disk drive 0. 
The command format Is: 

devtob|file,dev:l3tfile»devtsourcs) file 

The device names are as follows: 

Device CP/M I5IS-II 



Disk drives 


A:, B* f C«t~- 


•FOi, sFl:, ttts. 


Line printer 


LST: 


LSTi 


Teletype or CRT 


TTY: 


TTYi 


Hi on speed reader 


HSR: 
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Examples; 
•JTY^TCST 



•SWALL.TTY»SiTCST 



2^.2 Switches 



Assemble the source file TEST-MAC and list the pr ogra m on 
the console. No object code it generated. Useful for error 
check. 

Assemble TEST .MAC (found on disk drive B), place the object 
file in SMALL-ftEL, and list the program on the console. 



A switch Is a letter that Is appended to the command string, preceded by ■ slash, ft 
specifies an optional task to be per f otmed during assembly. More then one switch can be 
used, out each muat be preceded by a slash. (With the TEKOOS operating system, switches 
are preceded by commas or ipaces. See Appendix A.) All switches are optional. The 
available switches arei 



Switch 

O 
H 
R 

U 

c 



Examples! 
**TEST/L 



Actlon 

Octal listing 

Hexadecimal listing (default) 
Farce generation of an object fi Le 
Force generation of a listing file 
Force generation of a cross reference file 



Assemble TEST.MAC, place the object file in TEST.REL 
and a listing file In TEST-PRN. Ottth ISIS-Q, the listing 
file it TEST-LST.) 



•-TEST/L/O 
*t_AST«TEST/C 



Seme at above, but listing file e dd iessas will be in octal. 

Assemble TEST-MAC, piece the object file In LA5T.REL 
and cross reference file in TEST.CRF. (See Chapter 3.) 



2.3 FORMAT GF MACRO-80 SOURCE FILES 



Input source Unas of up to 132 characters In length ere acceptable- 



MACRO-SQ preserves lower Ceee letters in quoted strings and comments. All 
symbols, opcodes and pseudo-opcodes typed in lower case will be converted to 
upper esse. 

If tha source file includes tine numbers from an editor, each byte of the line 
number must have tha high bit on. Una numbers from Microsoft's EDIT-SO Editor 

are acceptable. 
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u3.I Statements 

jource fl!«t input to MACRO-80 Consist of itatementa of the fcrmt 
[label £: D (operator Her gumentsl fccornment] 

4;h the exception of the ISIS assembler S controls (*a» Section 2-11), It is not necessary 

net statements begin in column I. Multiple blanks or tabs may be used to improve 
readability. 

J a label is present, it is the first Item In the statement and is Immediately f oUoweo by a 
colon. If it is followed by two colons, it la declared as PUBLIC (see ENTRY/PUBLIC, 
Section 2.6.10). For examplei 

FCOti RCT 

Is equivalent to 

FOO PU6UC FOO 

RET 

The next item after the label, or the first Item on the line If no label is present, is an 
o aerator. An operator may be an 8080 or Z90 mnemonic, pseudo-op, macro call cr 
egression. The eveluatlon order Is ea follows: 

1. Macro call 

2. Mnemonic/Pteudo operation 
J. Egression 

Instead of flagging an egression as an error, the assembler treats It as If it were a C3 
stscement (see Section 2.6.A). The arguments following the operator will, of course, vary 
in form according to the operator. 

.. comment always begins with a semicolon and ends with a carriage return. A comment 
may be a line by Itself or It may Be appended to a line that contains a statement. 
Extended comments can be entered using the .COMMENT pseudo operation (see Section 
2.6.20). 



L3.2 Sy_n*ao:s 

MACRO-30 symbols may be of any length, however, only the first six characters 
significant. The following character* are legal in a symbol] 



A-Z M S . ? 9 

with Microsoft's 9080/290/9086 assemblers, the underline character is also legal 
in a symbol. A symbol mey not start with a digit. When a symbol is reed, lower 
case is translated into upper case. If a symbol reference is followed by 09 it is 
declared external (see also the EXT/EXTRN pseudo-op, Section 2.6.12:. 
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2-3.3 Numeric Constanta 

The default base for numeric constants Is decimal- This may be changed by the 
.RADIX pseudo-op (sea Section 2-6.22). Any base from 2 (binary) to IS 
(hexadecimal) may be selected. When the base is greater than 10, A-F are the 
digits following 9. If the first digit of the number Is not numeric the number 
must be preceded by a zero* 

Numbers are 16-bit unsigned quantities. A number is always evaluated In the 
currant radix unless one of the following special notations la used: 



nrwnB 


Binary 


rtrmnO 


Decimal 


nrmnO 


Octal 


nnnnQ 


Octal 


nnnnH 


Hexadecimal 


X*nmn* 


Hexadecimal 



Overflow of e number beyond two bytes Is Ignored and the result Is the tow order 
la-bits. 

A character constant is a string comprised of zero, one or two ASCII characters, 
delimited by quotation marks, and used In a non-simple expressicn. For example, 
in Che statement 

08 W * 1 

'A* is a character constant. But the statement 
06 'A' 

uses 'A' as a string b ec ause) it la In a simple expression. The rules for character 

constant delimiters are the tame ea for strings. 

A character constant comprised of one character has as Its value the ASCII value 
of thet character. That Is* the high order byta of the value Is zero, mrd the low 

order byte is the ASCII value of the character. Tor example, the value ofthe 
constant 'A' is 41H. 

A character constant comprised of two characters has as Its value the ASCII 
value of the first character in the Woji order byta and the ASCII value of the 
second character In the low order byte. For example, the value of the character 
constant "A6T is •lH»2*e*42H- 






a i"7:^q :J rcrr*pT.sed of ;sro cr mere cr'aracters ceiirrntec by c^ctaticn r^ar'<s, 
E".:hrr single or nc:-cie c-ctts ""ay oe csec as string delimiters. T h« delimiter 
qLCi#s may he used as cnaracters if they appear twice far every character 
occurrence desired. For example, the- statement 

C9 "I am '"c,r-3:* m today" 
stcres the string 

I am "great*' today 
If there are tero characters between tr* delimiters, the string is i null string. 

** #" * ^ *-^ ^ ^~ — <--ir-*h rw ^ i i % ™ V"* * I 



2.4,1 Arithmetic And Logical Co*;ratore 

T u e 'c.'icwir.g operator* ire allowed in expressions. The ooeraisrs are listed i: 
crcer of srscece-ice, 

LCW> HIGH 
[jr-arv Mirajs 



E-. NiE, L7, LEt3T.CE 

NOT 

ANO 

CR, XDR 

-i.-e"these« are used :c crarce the orcer of precedence. Coring evaluation of sr 
e-»OTe«;~n, as seen as a new iceratcr ;a erccuntered that has prececerce .ess 
than cr CQ^al to tne iast operator encountered, all operations «o tc the re* 
operator 3re performed. That is, subexpressions involving operators of higher 
precedence are computed first. 

Ail seer a tars except -, -, *, / must be separated from their operands by at leas! 
crt tcsce. 
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The byte isolation operators (HIGH* LOW) isolate the high or low order 9 bits of 
en Absolute 16-bit value. If e relocatable value is supplied as art operand, HIGH 
and LCW will traat it as if it were relative to location zero. 



2.4.2 Moriea 

All symbols used as operands In egressions are In one of the following modes: 
Absolute, Oats Relative, Program (Code) Relative or COMMON- (See Section 
2.6 for the ASEC, CSEG, DSEC and COMMON pseudo-ops.) Symbols assembled 
under the AScG, CSEG (default), or OSEG pseudo-ops are in Absolute, Code 
Relative or Data Relative mode respectively. The number of COMMON mode* in 
a program a determined by the number of COMMON blocks that have been 
named with the COMMON pseudo-op. Two COMMON symbols are not in the 
same mode unless they are in the same COMMON block. 

In any operation other than addition or subtraction, the mode of both operands 
must be Absolute. 

If the operation is addition, the following rules apply: 

1. At least one of the operands must be Absolute. 

2, Absolute ♦ <mode> « Cmode> 

If the operation is subtraction, the following rules apply: 

1. <mode> - Absolute * <mode> 

2. <mode> - <mooe> • Absolute where the two <mode>s are the same. 

Each intermediate step in the evaluation of an expression must conform to the 
above rules for modes, or an error will be generated. For example, if TOO, 6AZ 
and ZAZ are three Program Relative symbols, the expression 

TOO ♦ BAZ - ZAZ 

will generate an R error because the first step (FOO * BAZ) adds two relocatable 
values. (One of the values must be Absolute.) This problem can always be fixed 
by Inserting perentheses. So that 

FOO * (BAZ - ZAZ) 

is legal because the first step (BAZ - ZAZ) generates an Absolute value that is 
then added to the Program Relative value, FOO* 
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2.i.3 Externa Is 

Aside from its classification by mode, a symbol is either External or not 
External. (See EXT/EXTRN, Section 2-6.12.) An External value must be 
assemoled into a two-byte field. (Single-byte Externals are not supported.) The 
foilowinc, rules apply to the use of Externals in expressions: 

1. Externals are legal only in addition and subtraction. 

2. If an E^temai symool is used in an expression, the result of trie 
expression is always External. 

3. 'Mien :r* operation is addition, either operand (bet not bcth) may be 
External. 

4. When tre operation is subtraction, only the first operand may be 
External. 



2.5 QPCCQES AS OPERANDS 

BCaO opcodes are valid one-byte operands. Note that only the first byte Is a 
valid operand. For example: 



MVI 


a.:z*p) 




CCP!J 


mv: 


b.;rn£ 


CP\ 


£inx h) 


AC I 


(lxi s; 


MVI 


C,MCV A,3 



Errors will be Generated if mete than cne byte la included in the operand — such 
as (C?l 51, LXI 9,LA6EL1) or (JMP LABEL2). 

Cocodes used as one-byte operands need not be enclosed In parentheses. 



NOTZ 

Opcodes are not valid operands in ZSO mode. 



li PSEUCC CPEHATiCNS 



2.6J. ASEC 



ASEG 

ASEG sets the location counter to an absolute segment of memory. The location 
of the absolute counter will be that of the last ASEG (default is 0), unless an 

CRG is ccne after the ASEG to change the location. The effect of ASE3 is also 
achieved by usinc, the code segment (CSc£) paeucb operation end the /P switch 
in LINK-SO. See also Section 2.6.2S. 
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2.4.2 COMMON 

COMMON /<block name>/ 

COMMON sacs the location counter to tha selected common Mock in memory. 
The location is always tha beginning of tha area so that compatibility with the 
FORTRAN COMMON statement is maintained. If <&lock name> is omitted or 
consists of spaces, it Is considered to be blank common- See also Section 2-6-2B. 

LAJCSEG 

cseG 

CSEC sets tha location counter to tha coda relative segment of memory. Tha 
location will be that of tha lest CSEC (default la 0), unices an ORG is done after 

tha CSCC to chance tha location. CSEG is tha dafautt condition of tha 
aaaamblar (tha INTEL assembler defaults to A5EG). See also Section 2-4.28. 



2-«U 08 - Define Byte 

08 Cexp>{,<exp>.J 
OB <strinoX<Atrina>^] 

Tha arguments to 08 ara either expressions or strings. OB stores tha values of 
tha expressions or the characters of the strings In successive memory locations 

beginning with the currant location counter. 

Expressions must eveiuata to one byte. (If the high byte of tha result la or 255, 
no error Is given; otherwise, an A srror results.} 

Strings of three or mora characters may not be usad In expressions (1.*., thsy 
must be immediately followed by e comma or the end of the line). The 
characters in a soring ara stored In tha order of appearance, each aa a one-byte 
value with tha high order bit sat to zcro- 

Example: 



0000* 


4142 


OS 


'AB 1 


0007 


42 


08 


'AB , Ar«0rTH 


0003' 


4142 43 


DB 


'ABC 



Utility Software Manual 11 

MACRO-80 ASSEMBLER 



2-i.S QC - Define Character 

DC <strtng> 

DC scores the characters in <atring> in successive memory location* beginning 
with the current location counter. As with OS, char acta ra are stored in order of 
appear an ca, each as a one-byte velue with the high order bit set to zero. 
However, DC store* the last character o* the string with the high order bit set to 
one. An error will rests* if the argument to OC is a nuU string. 

1A-6 OS - Qeftno Spec* 

OS <«*p> 

05 reserves an area cf memory. The value of <exp> gives the number 9f bytes tc 
be allocated. AU names used In <exp> must be previously defined (i.t-, ail names 
known at that point on peas 1). Otherwise, a V error is generated during pess L 
end a U error may be generated during pees 2. [1 « u error la not generated 
during peas Z, a phase error will probably be ganereted because the OS generated 
no code on pess i- 



2-6.7 QSEG 

OSEG 

OS£G sets the location counter to the Oata Relative segment of memory. The 
location of the data relative countar will be that of the last OSEG (default is 0), 
unless an ORG is done after the OSEG to change the location. See aiso Section 



2.6U 0* - Define Word 

CM <expHp<e<p>— ) 

0\* stores the values of the expressions In successive memory locations beginning 
with the current location counter. Expressions are eveiueted as 2-byte (word) 
values. 



3Le»f£NP 

Eh© [<e*p> ) 

The EreO statement specifies the end of the program. If <exp> la present, it is 
the start address of the program, if <exp> to not present, then no start address is 

passed to UNK-80 for that program. 
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NOTE 

If vi assembly language program la the main 
program, a start address (label) must be 
specified. If not, UNK-80 will issue a "no start 
address" error. If the program is a subroutine to a 
FORTRAN progam (say) the start address ta not 
required aa FORTRAN has supplied one. 

2.6.10 EMTRY/PU6UC 

ENTRY <name>( ( <name>.„] 
or 

PUBUC <name>(,<nama>. M ] 

ENTRY or PUBLIC declares each name in the list at Internal and therefore 
available for use by this program and other programs to be loaded concurrently. 
AU of the names in the list must be defined In the current program or a U error 
results. An M error is generated if the name is an external name or 
common -block name . 



2.6J.1EGU 

<mme> EQU <exp> 

EGU assigns the value of <e*p> to <neme>. If <exp> la external, an error Is 
generated. If <name> already haa a value other than <exp>, an M error is 

generated. 

2-4U.2 EXT/EXTRN 

EXT <name>C,<name>™] 
or 

EXTRN <nama>( t <name>.«] 

EXT or EXTRN oedarea that the named) In the list are external (i-e., defined in 
a different program). If any item in the list references a name that is defined in 

the current program, an M error results. A reference to a name where the name 
is followed immediately by two pound signs (e.g^ NAME##) also declares the 
r^rrt^ as external. 



2.6J.3 INCLUDE 

INCLUDE <fllemme> 

The INCLUOE pseudo-op assembles source statements from an alternate source 
file into the current source file. Use of INCLUDE eliminates the need to repeat 
an often-used sequence of statements in the current source file. The pseudo-ops 
INCLUOE, SMCLUOE end MACLIB are synonymous. 
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<filename> t% any valid specification, as determined by the operating system. 
Defaults for filename extensions and device names are the same as those in a 
MACRO-80 command line. 

The INCLUDE file Is opened and assembled into the current source File 
immediately following the INCLUDE statement- V*>en end-of-flle Is reached, 
lembly resumes with Che statement following INCLUDE. 



On a MACRO-80 listing, a plus sign b printed between the assembled code and 
tf-e source line en each Una assembled from an INCLUDE file. CSee Section 2.1 2. J 

Nested INCLUDES are not allowed. If encountered, they will result in an 
ocjectioneble syntax error *0*. 

The file specified In the operand field must exist. If the file is not found, the 
error 'V (value error) is given, and the INCLUDE is Ignored. 



2. 6.1 A NAME 

NAME (*modnameO 

NAME defines a name for the module. Only Che first six characters are 
significant in a module name. A module name may also be defined with the 
TITLE pseudo-op. In the absence of both the NAME and TITLE pseudo-ops, the 
module name is crested from the source file name. 

2-6J.5 ORG - Qfine Origin 

ORG <exp> 

The location counter is sat to the value) of <exp> and the assembler assigns 
gen era tec code starting wich that value. All names used in <exp> must be known 
en pass 1. and trsy value must either be absolute or in the same area as the 
location counter. 

2.6-16 PAGE 

PACE [<exp>] 

PACE causes the assembler to start a new output page. The value of <exp>, if 
included, becomes the new page size (measured in lines per page) and must be in 
the range 10 to 253. The default page size is 50 lines per page. The assembler 
puts a form feed character in the listing file at the end of a page. 
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2.6.17 SET 

<name> SET <exp> ' 

SETT is the same as EGU t except no error Is generated If <name> is already 
ce fined. 

2.6*19 SJ8T7L 

SU8TTL <text> 

SUBTTL specifies a subtitle to be listed on the line after the title Csee TITLE, 
Section 2-6-19) on eacn page heading. <taxt> is truncated after 60 characters. 
Any number of SUBTTLs may be given in a program. 

2.&.19 TITLE 

TITLE <text> 



TITLE soecifiee a title to be listed en the first line of each page. If more than 
one TITLE is given, a Q error results. The first six characters of the title are 
used as the module name unless a NAME pseudo operation is used. If neither a 
NAME or TITLE pseudo-op ts used, the module name is created from the source 
filename. 



2.6.20 .COMMENT 

.COMMENT <celim><textXdelim> 

The rirst non-blank character encountered after -CCMMENT is the delimiter. 
The following <text> comprises a comment block which continues until the next 
occurrence of <dellmiter> is encountered. For example, using art asterisk as tne 

delimiter ,the format of the comment block would bei 

.COMMENT • 

any amount of text entered 

here as the comment block 



; return to normal mode 
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2-6-21 .PRINTX 



PfUNTX <c*UmXtext><deum> 

Th* first non-oler* character encountered after .PRWTX ai tha delimiter. The 
fallowing text is listed on the terminal during assembly until another occurrence 
of the delimiter is encountered. PRINTX is useful for displaying progress 
through a leng assembly or for displaying tha value of conditional assembly 
switches. For examples 

IF CPM 

.PRINTX /CPM version/ 

END IF 



PRINTX wiU output on both passes- If only one 
printout Is desired, use the IF1 or !F2 pseudo-op. 
For examples 



rt 

FCPM 
-PRINTX /CPM 

ENOF 

£NCF 



»/ 



2.6.22 .RADIX 



will only print if CPM is true and M80 is in pees 2. 



-RADIX <exp> 

The default base (or radix) for all constants la decimal. The .RADIX statement 
allows the default radix to be changed to any base In the range 2 to 16. Far 

example: 

MVI ftCFFH 

.RADIX 16 
MVI B,0FF 

The two M Vb in tha example are identical. The <exp> in a -RADIX statement is 
always in decimal radix, regardess of the current radix. 



"-:3 A SSL V £'_£?. 



2.3.23 .ZSO 

.ZSO ennolss the assembler to accept 230 opcodes. This ia tho defnult condition 
■M-\zn the »2semal*r is running on a ZSO aceratinc system. ZSO mode rnav a. re re 
set 2y aceencirg the Z swj-cn :s the "^ACRC-cC command string — tee Sezt.cn 



.£030 e^aalea the assemoier to accept 3C8C opcodes. This :s the si'uit 
condition when the assemoler ia running en an SC8C operating system. 3050 mode 
may also be set by appending the { switch to the MACRO-30 command string — 
see Section 2. 



*J ** 



.ACQUEST <f;:er-arre>I.<fi;era'"t>...] 

-^E--'wl3T teres • request te t.'e L>X-3C leader to seim t"^e fi>rxmw '.r f« 
list fflf jndef'rcd giocais. The filenames: in the Use should 3e in tr* frrm cf legs] 
$yr*\ccl3. They snculd net inc.ude filename extension* or cis- S>;c;f:C3t;or^, 
LINK-flO supplies a default extension and assumes the default disk drive. 



16.26 Corcit:cn.il Pseucc Cc^raciors 
Th$ conci t; or a. pseuds operations are: 

T'lr" %»-5> Th» if <e*c> is ret 2. 

;FE,y"F <*«o> True if <cxo> is 3. 

Fi True if pass 1. 

IF2 True if pass 2. 

7"£EF <symbo:> True ;f <symcel> :• defined cr has beer 

declared External. 

IFNCE- <*ym3ci> True ;f <syrr.cci> .1 undefined or net rec.ar-d 

External. 

7*3 <arg> True if <srg> is blank. The angle brackets 

around <arg> are required. 

iFNB <arg> True if <arg> is not blank. Used for testing 

'*tfcr\ dummy parameters arcsuppiJed. The 
angle oracketa around <ar£> are recuirtc. 
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All conditional* use the following format: 
F«oc [argument] 



[ELSE 



. ] 
END IF 

Conditionals may be nested to any level. Any argument to a conditional must be 
known an pass 1 to avoid V errors and Incorrect evaluation. Tor IF, IFT, IF", 
and ]F£ the expression must involve values which were previously cefir.ed and 
Che expression must be absolute. If the name is defined after an IFOEF or 
JFNDEF, pass I considers the name to be undefined out it will be defined on pass 



2.6.26.1 ELSE - Each conditional peeudo operation may optionally be used with 
the ELSE pseudo operation which allows alternate code to be Generated wh«n the 
opposite concition exists. Cniy one ELSE is permitted for a given IF, and an 
ELSE is always bound to the most recent, open IF. A conditional with more than 
one ELSE or an ELSE without a conditional will cause a C error. 



2.6-26.2 EN OF - Each F must heva a matching ENDIF to terminate the 
conditional^ Otherwise, an tjrttermj noted conditionai* message is generated at 
the end of each pass. An ENCIF without a matching IF causes a C error. 



2.6.27 Ljs t;nq Control Pseudo Operations 

Output to the listing file can be controlled by two pseudo-ops: 
-LIST and -XLIST 

If a listing ia not being made, these pseudo-ops have no effect* .LIST is Che 
default condition. When a .XLIST is encountered, source and object code will not 
be listed until e -LIST is encountered. 

The output of cross reference information is controlled by -CREF and .XCREF. 
If the cress reference facility (see Chapter 3) haa not been invoked, .CREF and 
.XCREF have no effect. The default condition la .CREF. When a JCCREF ts 
encountered, no cress reference information is output until iZRE" la 
encountered. 
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The output of MACRO/REPT/IRP/TRPC a>«3ansioni Is controlled by three 
pseudo-cos: .LALUi -SALL, and .XAUL. -LALL Hats the complete macro text for 
ail expansions- -SALL lists only the object code produced by a macro and not its 
text. .XALL is the default condition; it m similar to .SALL, except a source line 

is listed only if it generates object code- 



2.6.28 Rejocation Pseudo Operations 

The ability to create relocatable module* is one of eras major features of 
Microsoft assemblers. Relocatable modula* offer the id vantages of easier 
cadtng and Taster tatting, debugging and modifying. In addition, it is possible to 
specify segments of assembled code that wtU later be loaded into RAM (the Data 
Relative segment) and ROM/PROM (the Code Relative segment). The psevdo 
operations that select relocatable areas are CSEG and OSCG. The AS£G 
pseudo-op is used to generate non-relocatable (absolute) code. The 
CCMMCNpaeudO-Op creates a common data area for avstry COMMON block Wat 
is named in the program. 

The default mode far the assembler is Coda Relative. That a y assembly beans 
with a CSEG automatically executed and the location counter in the Code 
Relative mode, pointing to location in the Code Relative segment of memory. 
All subsequent instructions will be assembled into the Code Relative segment cf 
memory until an ASEG or OSCG or COMMON pseudo-op is executed. For 
example, the first OSCG encountered seta the location counter to location zero 
in the Oata Relative segment of memory. The? following code is assembled in the 
Oata Relative mode, that is, it is assigned to the Data Relative segment of 

memory. If a subsequent CSEG is encountered, the location counter will return 
to the neat free location in the Code Relative s egment and so on. 

The ASEG, DSEG, CSEG pseudo-ops never have- operands. If you wish to alter 
the currant value of the location counter, use the CftG pseudo-op. 

* 

2.6.28.1 ORG Pseudo-op - At any time, the value of the location counter may be 
changed by'use of tne the ORG pseudo-op. The form of tha ORG statement is: 

ORG <e*p> 

where the value of <e»p> wilt be tha new value of tha location counter in the 
currant mode. AD names used in <exp> must be known on pass 1 and the value of 
<eie>> must be either Absolute or in the currant mod* of the location counter. 
Far example, tha statements 

OSEG 

ORG 50 

set tha Oata Relative location counter to 30, relative to tha start of tne Data 
Relative segment of memory* 
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2-6.28.2 LlNk-fiO - The LINK-80 Unking loader (see Chapter * of this manual) 
combines tr»e isgmencs and craatat each relocatable module in memory when the 
program s loaded. The origins 0/ the relocatable segments are not flxeo until 
the program .s loaded enc the origins an assigned by :_I. v *<-80. The commard :c 
L>«X-6C m*y contain user -spec! fled or.gins through the use of the /P (for Code 
Peietivei and 10 Cfor Oats and COMMON segments) switches. 

For example, a program that begins with the statements 

A*0 

CRC 80CH 

and S3 assembled entirely In Absolute mode will always toad beginning at BOO 
uni«ss the ORC statement is changed in the source Tile. However, the tame 
program, assembled m Code Relative mode with no ORG statement, may be 
loaded at any specified address by appending thai /PKaddresa) switch to the 

LINK-30 command string. 

- 

2.6.29 Relo cation Sefcre Loading 

Two pseuco-ope, -PhaSC and -OCPHASE, allow code to bo located in en* area, 
but executed only at a different, specified area* 



For example: 








00CO- 






PHASE 100H 


0100 


E3 0CC3 


FOOi 


CAU. BAZ 


0103 


E9FF01 




JMP zco 


Qlfifi 


C3 


BAZ: 


RETT 

-OcPHASE: 


OC07* 


E9 FFF8 


ZOOi 


JMP 5 



A!i labels within s PHASE block are defined aa the absolute value from the 
origin of the phase area. The code, however, is loaded In the current area (i.e.. 
from 0* in this example). The> code within the block can later be moved to IOOh 
and executed. 



2.7 MACROS AND BIOCX PSCUCQ CPERAT1QNS 

The macro facilities provided by MACRO-80 include three repeat pseudo 
operations! repeat CREPT), Indefinite repeat (IRP). and Indefinite repeat 
character (IRPO. A macro definition operation (MACRO) b also pro viced. Each 
of these four macro operations is terminated by the £hOM pseudo operation. 
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2.7.1 Terms 

For the purposes of o Hort aion of macros and block operations, the following 

term* will be used; 

L <oummy> Is used to r epres ent e dummy parameter. All dummy 
parametefs are legal symbots treat appear in the body of a macro 

expansion. 

2. <dummyHst> Is a Use of <dummy>s separated by commas. 

3. <argltst> is a list of arguments separated by commas. <arglist> must 

be delimited by angle brackets. Two angle brackets with no 
intervening c ha r a cters (<>) or two com m a s with no intervening 
characters enter a null argument in the list. Otherwise an argument 
Is a characttr or series of characters terminated by t comme or >. 
with angle brackets that are nested inside an <argtist>, one level of 
brackets b rem o ved each time the bracketed argument is used in an 
<argjist>. (See example, Sactton 2-7.5.) A quoted string Is an 
acceptable argument and Is passed as such. Unless enclosed In 
brockets or a quoted string, leading and trailing spaces are deleted 

from arguments. 

4. <paramiist> is used to represent a ttst of actual parameters separated 
by commas. Mo delimiters are required (the list Is terminated by the 
and of line or a comment), but the rules for entering null parameters 
and nesting brackets era the same as described for <argust>. (See 
example. Section 2.7.5) 



2,7.2 RE?T-gsOM 
REPT <asp> 



ENDM 

The block of statements between REPT and EM3M b repeated <exp> times. 
<exp> is evaluated as a 16-bit unsigned number. If <exp> contains any external 
or undefined terms, an error is generated. 

Exemplar 



generates OB 1 • 06 10 



SET 





REPT 


10 


SET 


X*l 


08 


X 


QsOM 
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2.7.3 :??-E>CM 



\f\P <Cummy>,<ar3L;st> 



~^e <*arg:isO must be enclosed In angle brackets. The number of srs"jmtrts in 

the <arclist> determines the number of times the block of statement .j 
repeated. Each repetition substitute! the next item in the <arglist> Per ever/ 
occurrence of <Cunmy> in the block. If the <arglist> is null (i.e., <», the blocU 
is processed cnce with each occurrence of (dummy) removed- For example: 

IRP X,<l v 2 t 3.4 v 5,a\ l 7 p S,9 9 11» 

C8 X 

EfOM 

generates the lama bytes as the R^T example. 



17.itPPC-c\CM 



IRFC <dummy> t string Cor <*tring>) 



ENCM 

tRPC is similar to !RP but the arglist is replaced by a string ef text and the 
angle brackets around the string are optional. The statements in the block are 
repeated cnce for each character in the string. Each repetition substitutes the 
rvxi character m the string for every occurrence of <dummy> in the blocx. For 
example: 



a* % 



PC X,0I2J«i56789 

OB X+l 

ENOM 

generates the same code as the two previous examples. 



2.7.5 M*CPO 

Often it is convenient to be able to generate a given sequence of statements 
frcm various piaces in a program, even though different parameters may be 

re cut red each time the secuence is used. This capability is provided cy the 

MACRO statement. The form is 

Cname> MACRO <dummyliat> 
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where <mmt> conforms to the; rule* for farming symbols. <nam*> is the name 
that will be usee to invoke the macro. The <dummy>t in <dummy!ist> are the 
parameters that will be changed (replaced) each time the MACRO is invoKed. 
The statement* before the E>OM comprise the body of the macro. Dunne 
assembly, the macro is expanded every time it is invoke* Out, unlike 
REPT/IRP/IRPC, the macro is not expanded when it is encountered. 

The form of a macro call Is 

<name> <par*mllst> 

where <neme> is the name supplied in the MACRO definition, »n€ the 
parameters in <paramfist> will replace the <dummy>* in the MACRO 
<cunvnyiist> on a one-to-one basis. The number of items in <dummylist> and 
<?aramtist> is limited only by the length of a line. The number of parameters 
used when the macro Is called need not be the seme ss the number of <dummy>s 
in <dummylist>. If there are more parameters then <dummmy>a, the extras are 
ignored. If there are fewer, the antra <dummy>s will be made null. The 
assembled code will contain the macro expansion code after each macro call. 



NOTE 

A dummy parameter in e MACRO/REPT/IRP/IRPC is 

always recognized exclusively as 3 dummy parameter. 
Register names such as A and B will be changed in the 
expansion if they were used as dummy parameters. 



Here is an example of a MACRO definition that define* a macro called FOC: 



FCO 


MACRO 


X 


Y 


SET 







REPT 


X 


Y 


SET 


Y*l 




ce 


Y 




ENDM 






ENOM 





This macro Generate* the seme coda a* the previous three examples when the call 

FOO ID 

is executed. 
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Arcther exampie, whicn generates the sane cede, illustrates the removal cf ere 
ie'-e: of* brackets *htn an argument j used as an aro,iist; 

r CC MACRO X 

:pp v r <x> 

ENOM 

ENCM 

When the call 

FCO <l t 2,3,4 ff 5,e. t 7,8,9 t 10> 

>s ^aCe. t ^e macrc expansion leaks like this: 
\FP Y,<:,2 ( 3 ( 4,3 f 5,7,3,9,10> 

re y 

ENOM 



17.5 ENCM 

Every REPT, IPP, TRPC and MACRO pseudo-op must be terminated with the 
ENOM pseudo-op. Otherwise, the "Unterminated REPT/IRP/tRPC/MACRC 
mriioqe is generated at the end of eacn pass. An unmatched ENOM causes an G 
error. 



2.7.7 EXfTM 

The EXITM pseudo-op is used to terminate a REPT/IRP/IRPC cr MACRO call. 
Wher an E-<;tm * executed, the expansion j exited immeciate.y anc* my 
r^'-ainjng exoans:on cr repetition is not generated. If the block containing the 
EXITM is nestec within another Sleek, the cuter level continues to be expancec. 



2.7.3 LOCAL 

LOCAL <dummyUst> 

The LOCAL pseudo-oo is allowed only inside a MACRO definition. When LOCAL 
is executed, the assembler creates a unique symbol for each <dummv> :n 
<dummy!ist> and substitutes that symbol for each occurrence of the (dummy) in 
the expansion. These unique symbols are usually used to define a label within a 
macro, thus eliminating multiply-defined labels on successive expansions of tne 
macro. The svmtcls created by the assembler range from ..0CC1 :o ..r rrr . 
L"~?rs will therefore want to avoid the form —nnnn for the*.r cwn symbols. If 
LCCAL statements are used, they must be the first statements m the .^acro 
Ceflmtion. 
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2.7.9 Special Macro Ooeratori And Forma 

& The ampersand is used in a macro expansion to concatenate text or 

symccls. A dummy parameter that Is in a quoted string will .-ict ce 
substituted in the enoansicn unless it :s immediately preceded by oi. To 
form a symooi from text and a dummy, put & between them. For example: 



ERRGEN 


MACRO 


X 


ERROR&X; 


PUSH 


8 




MVl 


B/&X' 




JMP 


ERROR 




ENDM 





In this a xampie, the call ERRCENA will generate: 

ERRCRA: PUSH B 

MVl B.'A' 

JMP ERROR 

X; In a block operation, a comment preceded by two semicolons is not saved 

as part of the sxpansion (i-e., it will not appear on the listing even uncar 
-LALL). A comment preceded by one semicolon, however, will be 
preserved and appear in the expansion. 

T When an exclamation point is used in an argument, the ne*t character is 

entered literally (i.e., !; and <;> are equivalent). 

NUL NUL is an operator that returns true if its argument (a parameter) is lull. 
The remainder of a line if tar NUL la considered to be the argument to 
NUL- Tho conditional 

F* NUL argument 

is false if, during the expansion, the first character of the argument .a 

anything other than a semicoion or carnage return. It is recommenced 

that testing for null parameters be done using the IF3 and IFXB 
conditionals- 
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2. a USING Z80 rSEUCO-CPS 

'Atten using the MACRO- 80 assembler, the following Z80 pseuco-ccs are valid. 
The function of each pseudo-op is equivalent to that of its counterpart. 



Z9D pseudo-oo 


Eouivalent pseudo-co 


CONO 


FT 


E.NCC 


ENOIF 


•EJECT 


PAGE 


OEFB 


ce 


DEFS 


DS 


DEFW 


ow 


OEFM 


06 


cen. 


SET 


CL08AL 


PUBLIC 


EXTERNAL 


EXTRN 



The formats, where different, conform to the previous format. That is, DEFB 
and DEFW are permitted a list of arguments (as are DB and DW5, and DEFM Is 
permitted a string or numeric argument (as is OB). 
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2.9 SAMPL£ ASSEMBLY 



A>M6C 



•£XMPLl T TTY:*EXMPLl 



MAC 90 3 2 PAGE 







C0100 


lCSL3(Pl,P2) 








00200 


(SHIFT PI LEFT CIRCULARLY 3 


sits 














00300 


;R£TURN RESULT IN P2 






0O4OQ 


ENTRY CSL3 








00450 


jCET V ALUE 


or f:rst 


PARAMETER 




00500 


CSL3: 




OOCCP 


TE 


006 00 


MOV 


am 


0001' 


23 


00700 


INX 


H 


0002' 


U 


00800 


MOV 


H t M 


0003' 


&r 


00900 

0100 Q 


MOV 
jSHffT COUNT 


L.A 


0C04* 


06 03 


0X1CO 


MVI 


8,3 


C006* 


AT 


oi ro 

01300 


LOOP: XRA 

iShft let t 


A 


0007' 


19 


01400 
01500 


oao 
.-rotate *4 cy bit 


H 


COOS' 


17 


0I6CO 


RAL 




C0C9» 


•5 


01700 


ADO 


L 


0C0A« 


*r 


01600 


MOV 


L.A 






01900 


^DECREMENT COUNT 


0008 # 


05 


020CO 
02100 


CCR 
;CNE MORE TIME 


B 


0C0C' 


C2 0006* 


022CO 


JNZ 


LCCP 


ocor 


E3 


023OO 


XCHG 








02*00 


jSAVE RESULT 


M SECCNO 


PARAMETER 










0010- 


73 


02500 


MOV 


M£ 


Q011' 


23 


026CO 


INX 


H 


0012* 


72 


02700 


MOV 


M£ 


0013' 


C9 


0230O 
02900 ENO 


RET 





MAC 80 3.2 PAGE 



c sl3 cooor 



LCCP 



QOOtf 



No Fatal error(s) 
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2.1C MACRO-8C ERRORS 

VACRC-SC errors are indicated by a one-character flag in column one of the 
!ist:ng *ile. \f a tist:ng file * not being printed on the terminal, eacn errcreoua 
line s also printed or Cisoiayed on the terminal. Selcw is a list cf the 
VACPC-cC Error Codes: 

A Argument error 

Arcument to pseudo-op is not in correct format ot is Out of range 
(PAGE 1; -RADIX 1; PUBLIC lj JMPS TCOFAR). 

C Conditional nesting error 

ELSE without T r ENCIF without IT, two ELSEs en one IF. 

C Oci£Ie CeTmed symbol 

Reference to a symcol which ia multiply defined. 

E External error 

Use of an external Illegal in context (e.g., FOQ SET NAMEtftf; 
LXI B,2-NAM£fftf). 

M Multiply Defined symbol 

Definition of a symbol which ia multiply defined. 

N Number error 

Error ;r. a number, usually a bad digit 'e.g., 8G1- 

O Bad oocode or objectionable syntax 

ENDM, LCCAL outside a block? SET, EQU or MACRO without a 
name; bad syntax in an opcode; or bad syntax in an expression 
(mismatched parenthesis, quotes, consecutive operators, etc./. 

P Phase error 

Val^e of a label or EQU name ia different on pass 2. 

Q Guesttonaole 

Usually means a line is not terminated properly. This is a warning 

error (e.g. MOV AX.8XJ. 

R Relocation 

Illegal use of relocation In expression, such as abs-rel. Data, cede 
and COMMON areas are relocatable. 

U Undefined symbol 

A symooi referenced in an expression is not defined, (Fcr certain 
pseudo-ops, a V error is printed on pass 1 and a U on pass Z. J 

V Value error 

Cn pass I a pseudo-op which must have its value known on oass i 
(e.g.. .RADIX, PAGE, DS, IF, IFE, etc.), has a value which is 
undefined. If the symbol is defined later in the program, a U 
error wiU not appear on the pass 2 listing. 
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Crror M aafaaj aaj 

1^0 and statement encountered on Input fiW 

No END stotementi either It w missing or It 
Is not pined duo to being In ■ false 
conditional, unterminated 1RP/IRPC/REPT 
block or terminated macro* 



Unterminated conditional 

At toast ona conditional to untormlnatad at 
tha and of tha file. 



^terminated R£PT/RPmPC/MACRO- 
laaat ona block bj untarmlnateeV 



CnltNo] Fatal errorW Lax warnings] 

Tho numbar of fatal arron and w arn in g s. 
Tha message is listed on tha CRT and In tha 
list fUa. 



ill Cp+ATIBUJTY WjTH OTXR ASSEMBLERS 

Tha SEJEGT and STOLE con tr o ls are provided for cotnpatabiBty with INTEL** 
IStS assembler. Tha dollar sign must appaar In column 1 ertty If apaeaa or tabs 

separata the dollar sign from tha control word. Tho control 



ta tho lama as tha MACRO-aB PAQE pseuds-op. Tha control 

fTTTLECtaxrt 

h tha aama aa tha MACRQ-M gJSTTL Cto*t>pso u do op . 

Tha aVTEL operands PAGE and fPAGC gen er a te Q errors whan uaad with tha 
MACRO-dO CSEG or DEC ps o ude-o p s. Thaaa arrora ara warnings; tha 
sssembter Ignores tha operands. 

When MACRO-JO hi entered, tha daf suit for tha origan is Coda Relative 0. with 
tha IMTEL CSIS oasembter, tha default la Abaohita 0. 
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Y*th MACRO-80, Che doUar sign ($) is a defined constant that indicates the value 
of tne location counter at the start of the statement. Other aasemolers may use 
a decimal point or an asterisk. Other constants ara defined by MACRC-60 to 
have the following values: 

a«0 D»2 Hm4 M=6 PSW=6 

C-l E»3 L«5 SP«4 A«7 

2.12 FORMAT OF USTTNGS 

On each page of a MACRO-60 Ustinov tha first two Una* have the forms 
[TITLE text] M8G 3.3 PAGE *£-»] 

{subttl tax] 



where i 

X. TTT^E text ia tha text supplied with tha TITLE pseudo-op, if one waa 
given in tha source program. 

2. x is the major page number, which is Incremented only whan a form 
feed is encountered in tha source file. ftVhen using Microsoft's 
EDIT -80 text editor, a form feed is inserted whene var a page mark is 
cone.) whan tha symbol table is being printed* x * % 

3. y is the minor page number, which la incremented whenever Che 
PAGE paeudo-oo is encountered in tha source file, or whenever the 
current page site has bean filled. 

4. SU8TTL text la the text supplied with tha SJBTTL ps e udo-op, if one 
was given In the source program. 

Next, a blanU line is printed, fallowed by the first Una of output. 

A lirm of output en a MACRO-80 listing has the following forms 

(erf #] [error] toceVn Ixx I xxxxi— 



If cross reference information ta being output, tha first item on the Una b tha 
cress reference number, foUowed by a tab. 

A one-latter error coda followed by a apace appears next en tha Una, if tha llrm 
contains an error, if there is no error, a space la printed, tf there is no cross 
reference number, tha error code column is the first column on tha listing. 

The value of the location counter appears next on tha Una. It it a 4-dlgit 
hexadecimal number or 6-digit octal number, depending on whether the /O or /H 
switch was given in tha MACRO-80 command string. 
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~~e character it t~e ere :* t*« Iscat! 



?n ccunter value -j tr-e -ncce '.r.t.cilcr 



re -< eia:: ve 

:s ~.?.3t. v* 
i-'.'MO. =*»iativa 



<sc»c*> 



=_xtrrn3( 



Next, three spaces are printed followed by the assembled code. One-byte values 
-ire followed bv a space. Two-byte values are followed by a rr.oce indicator. 
Twc-byta vaJues ~xe pr:rtec m tre ocoosite order they are stored ,r». i.e., tne 
K i^r» rr"er bvr.e is rn.nteC ?;r:t. Externals are either trie offset or trie value cf 
t"e pcirter to trie -ext Externa; in t*e z^3:n. 



:* i iirm :f Ou':xjt :r a MAi_?"-3C listing ;a 'rem an INCL'JCE '•>. t^e 
- ^a-* -*f -i 'f»,^ ^rr-^-nn *-'«»"* R^ — £"D t 'CO '?pr v j i'u* tier* '»* .% **i — *m + 



- - "rn- 



rcr : to e oss^^c.*- ccce cr i^-a: are. 



*"-« rs™a:~cer cf :he are con£i:ra t~.e lirte af scurcs cccc, as It was .r.pu:. 
Ewmpie- 

0C49 3A A9!Z r C+ LDA LCOUNT 

•C* 1 indicates this line is from »n INCLUDE file and part of a macro expansion, 



z.:z.: s^t-co; iric L-5t;nq 



_ . ir j - ..■»'*! blviff ■*•%»< ^ * *>»* " - ow • w ■ O f * <n < * 1 »-■ ^ p^# rf *^ . J us . . 2 *. ^ td 

-"-';cr cac- 5>"-sc:. a tac :* sr.ntec. *sUo w td -•-■ :re -aJ--;e of ire- -.•-•^•oc-- !' v*e 
i»-— =r. .s ^LEUIC, an ; .* ^r;-tod "jnned. Jttiy after tr*e -a.-e. *^e ^e »: 

rry.-3c:er cr.-:trf'- •*:(". =e ;re oi ;r« fjtiiwjnc; 



U 



Undefined v/moal. 

COMMON block name. (The "value" of the COMMCN block is lis 
length (number of bytes) in hexadecimal or octal.) 

External symbol. 



<spacs> Absolute value. 






"3ta =,e!at;ve value. 



;wc\ Re:juvc vaiue. 



_:.;;:> Dcft^are va~^s: 



Cf-APTER 3 
;hEF-80 CRCS5 REFERENCE FACILITY 



If ycu are using :r:e TEKECS ^p^rotinq sy*t#m, 
sets Apo^nc;* A fcr proper comrrand formats. 

In crder tc ^conrsta a crcr^ ref erflrc* !ist:nrj, the 3c:jr*mbler rr^ust cutrul a 






# V. 



_ rw, l *. .j -j: 



i\'.~c. l"« 'i^e'^s.^r ccers ^ .CRF ':^tf ;rsti?uc C? a .^jT file. 

IS*/ 



^. *i,27 fcr tr« .CPEF sne *XCREF pseuco-opi 



nxaaioics: 



Aise-^cie ftlt TES^-MAd ar<J cr*a:e oD'tc: '*> 



tJ*. 5 L^ a'*- cress refer^rct* 



jj— - - t - 



M«~ srv* rr*a?» -r<«^: r 



ftAd "ess r***jr*?— cs *i!c •^-P-r * 



When th* acsembler is finished t run t!"« crocs reference facility &y typing 
Cr I^SO. C--EFEO prompts the user -with an ar,t£r:2k. CREF5C generates a cress 
re*»r»"c-r .:s:i-.g frcm :he .CRF f;Lt trat *as cresiec during iwenci'. *"*i* 






"ne ccf^-jit extension fcr the source fiie is .CPS- There are no switch'** in 
CR£F3C irommancs. Example* of CP.EF-30 command stnnqs: 

•xTST E«arrme iiie TES7.CRF and c,er:er3t!» a cress re'erenc* !.st:n$ 



•Ta =.3" £<.vr;r# ';> 7E37.CRF and generate a crccs re'ersne: !.st;r^ 
' ; .i# 7.LST. 

Crcsa reference listing files differ from ordinary listing files in that: 

1. £adi tourer statement is numbered with a cross referfrice lunC^r. 

Z. -; :ne -yz o 4 :^ rt listir^, •■ iriatiie ~a:res s^se^r in ai?**astt r :rder 
;.?^"C *ith t"*e **_:— s^rj z* -~e .ires cr* #ftitfi trey 3;^ r»*er-'~t?- *r 

Sef,r«d. L..tb *urr.^e.*s cr. *~:cn :.-« syr^cci .j ce'.ne-i i.-e fiin.jo-: -:;.-. 






JBOW 

If TOu «r* -alng t'..« TXXSCS 
A for pcoptr cocaine forascs* 



7a* eor^AAd co cua -INK- 40 *s 



v«« 



i:x»&C r«C4ff&S U* proapt •■", ialicicin? it is ready to 



ir.-. cc-**r.d to L:~X-65 es.-.aists of * «ir.nc of ctjscc 
.!**.?.".• J iit&rs^ea 37 cc.t~.4S* 1..S4* 4* 1 tr.« i.l*s to C« 
£4£t£ c/ *I3S>M« T.'.« C©^. *."i for* it \$t 

.-,* 6*?&£«>t txct.isioA for o»,i fiiof.fcros .5 *\Im. c?;r.?iad 
•.*•*» i»t 4^??ort*<5# c>.4c ii, x«s i.v/oc4t. . «4;;-i crsrir.i ray 



to fe»*n w *^ ■— w v> * ■ -- 



Li *. - > 



G-sw ; 






*?I 1* 



C13X OCiVO U . 



*iivL :oo- s i.L.ol,£av2:ob~ £-l#2 , . . . g avn = ob; 



h ; * 



ijvicc ni^si «;i as listed ir* S^ccton 2. 2 



udw Kir r-^ij | rt ; * (V AUU 

,^-r fcacii lir.e is typed, LINK-30 will lOftd the specified 
, ?a. After LIKS tir.is.'.os this process, it will list all 
L£3ls that re.T.air.^G uncefir.ad followed by ar. asterisk. 

Zxa.-ple: 



kJ ffc * t\ 



C* * rt ft ^ ^ 

*0W U4U 



S^'3J\1 



(Si/Svcl is uncef inecj 



i L ij A* 



^.-i + .i 



C1O0 03CO 



9 ■ 






V- # /G face in 



h? i ■#» w ** k .i f 

■ 



ycu 
t/.e 



•h.*^:vs 






stiC is execu;;oa 



t . ^ 



*rf« .«..— c 



3 J 



< • 

* 



-0.T -*.■. ;.,; 

. *- .- ■ r — ■ - % . . . 

' * s fi . Hill • 



1 « . 



/ ^ - * . w 



ft . ' . » • V • ■ -> 
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5.1. 1 Mcdmes 

A module is typically a FORTRAN or COBOL subprogram, main program cr a 
MACRC-oC assemfcly that contain ENTRY statements. 

~"he primary function of LIE-3Q is to ccrcatenate -rcdules in .P.£L file* to *crm a 
new iicrary. In srcer to extract macules from previous libraries cr .R~_ 'il?*. a 
powerful syntax has been devised to specify ranges of modules within a -REL file. 

The simoJest way to specify a module within a file is simply to use the name of 
the mccuie. For example: 

But a relative quantity plus or minus 255 may also be used. For example: 

SDecifies the mcduie after SIN and 

SIN-1 

specifies the one oefare it. 

Ranges of mccules may also be specified by using two dots: 

-SIN means alt modules up to and including 5IN. 

SIN- means all modules from SIN to the end of the file. 

S«N-CCS means SIN and COS and all the modules in between. 

Ranges of modules and relative offsets may also be used in combination: 

SIN+1..CCS-: 

To select a given module from a file, use the name of the file followed by the 

mcdulr's; specified enclosed in angle brackets and separated ty commas: 

FCRUB <SIN~CCS> 

or 
MYUB.REL <TEST> 

cr 
HICUS.RzX <F7RST,MICDLZ,LAS7> 

etc. 

If no modules are selected from a file, then ail the modules in the file are 
selected; 

TESTLIB.REL 
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5.2 UIB-8G SWITCHES 



NOTE 

/E will destroy your current library Ef there It 
no new library under construction. Exit LI8-3C 
usjr.g Control-C if you ens not reviling the 
library. 



A number of twitches ere used to control LIB-80 o para 1 1 en. These switches ere 
always preceded by a sJashs 

/O Octal - set Octal typeout mode for /L command. 

/H Hex - set Hex typeout mode for A. command (default). 

/U List the symbols which would remain undefined on a search 

through the file specified. 

/L List the modules In the files specified and symbol definitions they 

contain. 

/C (Create) Throw away the library under construction and start over. 

/E Erit to CP/M. The library under construction (-LIB) is revised to 

,R£L and any previous copy is deleted. 

/R Rename - same aa /£ but does not exit to CP/M an completion. 



SJ UB-80 LISTINGS 

To list the contents of a file in cross reference format, use /Li 

•TCRUB/L 

v*ien building libraries, It is Important to order the modules such that any 
intermodule references are H forwsrd.• , That it* the module containing the global 
reference should physically appear ahead of the module containing the entry 
point. Otherwise, LlM<-40 may not satisfy all global references on a single pass 
through the library. 

Use Aj to Ust the symbols which could be undefined in e single pass through a 
library. If a module in the library makes a backward reference to a symbol In 

another module, AJ will list that symbol. Example! 
•SYSU8/U 
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NOTE 

Since certain modules in trie standard 
FORTRAN and CC80L system* are eiways 
farce- loaded, they will be listed as undeflnad by 
/U but will not cause a problem when loading 
FORTRAN Of COBOL program*. 

Listing are currently always sent to the terminal; use control-P to send the 
Usting to t-*ie printer. 



5.4 SAMPLE LIB SESSION 



A>LIE 



♦TR ANLI8 -SaN.CaSiT AN,ATAN^U.OC 
•EXP 

•TRANUB-UB/U 

•TRANLI8.LIB/L 



(List of symbols in TRAMJB-LJB) 



•fZ 
A> 



5.5 SUMMARY QT S0TTCHES AND SYNTAX 

/-J Octal • set listing radix 
fH Hex - set listing radix 

AJ List undefineds 

/L List cross reference 

/C Create - start LIB over 

/E Exit - Rename -LIB to -RELand exit 

/R Rename - Rename 4.IB to -REL 

module:: ■module name [* or - number} 

module sequence ::* 

modula I -module I module- I modulel.-mcduIe2 

file specif icaUont:*fUename {<module sequence>{ 1 <module sequence^} 
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AP"><CIX A 
•EKCC5 CPEr.AT^G SYSTEM 



The commend formats fcr MACRO-30, LINK-60 and CREF-30 differ sjghtLy 
uncer trie TEKDOS operating system. 



A.; *T*:C5Coi"^a.nc r".:«s 



» i 



■VI 



. ~ %- . an^ w :g Ji? aC + ~i*,,y .jr-nir.j .Ivj \_. - ^ %. fc.,.- ■ 

iw**e.?f, l^acer, a~c cress reference ::rop,rar".c respectively. ~ v ese c Ta*G 
Ilea l#l t^e e-^t-.at.tn -rcce ta C ar.i seiect :!*e I-=C asserrcter zroMSSOr ;e* 
T£**OC^ "cvenniiC*!, :n*n execute the arpr-cr:5te pre^W f:!e. v chj *'..! 
■*ct? '.m: riil of '.-"esc command files are let -..p to e*oc*jte :re M;Cr3S0*t 
oroqnm* 'ram drive «;i. As of v^r^icn }.?6, LINK -80 will also lock 'cr t"t 
library FCR LIS/ an enve #1. If ycu wish to e*ec*jta any of this software from 
cirve i/Q, the command file must be edited and L!M<-80 should be given an 
explicit library search directive "rCRLIB-S**. (See section 4.2.1.) 



-.: va-RCT-EC 



-^,> 



-::^ \rz.*rr~.cr accepts command r.r.ci criv. - prompt ;s ~ct C:S2:iv»: 2rc 



internet.** ccmmirvia are net acce;::20. Ccn-marcs nave t-e same 'srm-t as 
^EXCCS iscemcier commsrCs; i.e. f trtree filename cr device name par.irr.etars 
plL-s optional rwitcnes. 

M60 [obifiie][lstrile]-sourcefile [swl] [sw2...] 

The OOiect arid listrnc f;Je parameters are coticnal. These files wilJ ret be 
:r?a:r:; if *..*« sanmi-tjrs are cm] tied, however any error messages wt!: st:)! be 
i.sciavetf or tr-e *-r.sc.e. Tre avai.asie switc-es *re as cescr;Dcd in C^a^^er 2 3? 
t-^s **a~'.ai, except t."»C *.r< switcr.es are ce.ifr.jtec by commas cr sp3cet .n;;*33 
cf slas~es. 
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A.3 CRET-£0 

The form cf commands to CREF80 is: 

C90 lit file lource'lle 

6oth filename parameters are required. The source file parameter is at ways the 
nar-e of a CRErBO file created curing assembly, by use of the C switch. 

E*arnpie: 

Create a CREF30 file using MACRC-80: 

M80 „ TSTCRF TSTMAC c 
Create a cross reference listing from the CREF80 file: 
C80 TSTUST TSTCRT 



A.4 L3^-60 

Vrfcn TEXDOS, ti-e LINK-8G loader accepts Interactive commands only. 
Command lines are r.ot supported. 

Wien LlJ^-60 is invoked, ard whenever it la waiting for input, it will prompt 
with an asterisk. Commancs are lists of filenames and/cr devices separated by 
commas or soaces and cpticnally interspersed with switcnes. The input to 
L!h*<-80 must be Microsoft relocatable object code ( not the tame as TEKDCS 

Icacer format). 

Switches to LINK. 80 are delimited by hyphens under TEKOOS, instead of 
slasnes. All L!h*<-30 switches (as documented in Chapter 4) are supported, 
except "G* and "N*, whicn are not implemented at thla time. 

Examples: 

L Assemble a MACRO-flG program named XTEST, creating an object 
file called XRQ. and a Uating file called XLST: 

>M90 XREL XLST XTEST 

2- Load XTEST and save the loaded module: 

>LB0 
•XREL-E 
[CAAO 2288] 

•OOS»CRROR A6 

LSO TERMINATED 

>M XMOO 400 2288 CfcAD 
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Mete that •-E*" exits via an error message due to execution of a HLT instruction. 
The memory image is intact, however, and the "Module 1 " command may be used 
to save it. Once a program is saved in module format, it may then be executed 
directly without going through LINK -80 again. 

The bracketed numbers printed by L1NK-80 before exiting are the entry point 
acdress and the highest address loaded, respectively. The loader default is to 
bean loading at 40CH. However, the loader aiso places a jump to the start 
address in location 0, thereby allowing execution to bean at 0. The memory 
locations aetween 0003 and C4TJ0H are reserved for SR9*a and I/O buffers at 
runtime- 
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SECLUDE 


12 


Smemry 


33 


-COMMENT 


14 


•CR£r 


17 


-CEPHAS 


18 


•LALL 


17 


■UlST 


17 


.pace: 


U 


-PHASE 


18 


PRINTX 


14 


.RADIX 


5,15 


.REQUEST 


15 


-SALL 


17 


-XALL 


17 


.XCP£F 


17 


-XLIST 


17 


Absolute memory 


7-9, 28 


Arithmetic operators 


7 


A SEC 


7-9, 18 


Sicca cseuco ops 


19 


Character constants 


6 


Ccce Relative 


10, 17, 28 


Command format 


2, 31, 32, 42, 46, 47 


Comments 


5,14 


CCMMCN 


7, 9, 28-29 


Conditional* 


16 


Constants 


5 


CP/M 


2, 3, 31, 33-34, 36, 


Cross reference facility 


4, 17, 28, 30 


esse 


9, 10, 17, 27 


Data Relative 


7, 11, 18, 28-29 


ca 


6,10 


DC 


10 


Define 6yte 


6, 10 


Define Character 


10 


Defire Origin 


13 


Oelne Space 


11 


Define Wore 


11 


OS 


11 


osec 


7, 11, 17, Z7 


DW 


11 
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E^rr-so 


4, 28 


n cr 


16 


END 


11 


END IF 


17 


i\CM 


19-22 


£NTRV 


12.40 


ZCXJ 


12, 13 


Error cocfes 


26, 28 


Error message* 


27,37 


EXITM 


22 


EXT 


12 


Externals 


8, 12, 2*% 39 


EX7RN 


12 


F 


u 


IFL 


16 


•F2 


16 


IF" 3 


16 


TDEF 


16 


1FZ 


16 


;r F 


16 


[FN 6 


16 


:ft 


16 


[NCLUOC 


12 


INTEL 


27 


;p.p 


17, 20-22 


! C -FC 


17, 20-22 


:sts-a 


2,3, 34 


LIO-S0 


39 


Library manager 


39 


LINK -SO 


9, 11, 15, 13, 32. 41 


L latino 


12, 17, 28-29, 30, 31 




23 


Lcc,ical operator* 


7 


MACLB 


12 


MACRO 


17, 19-21 


Macro operator* 


23 


Mcces 


7 


Modules 


40 



NAM£ 13 

Operators 7 

CRG 9-11, 13, 18 

P ACS 13, 27 

Program Relative 7 

PUBLIC 5, 12, 29 

RE?T 17, 19-20 
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and 
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1. Add to MACRO- BO SWITCHES: 



Switch Arum 



P f»c* /P allocates an extra 256 

bytes M slack space for use 
> during assemDly. Use /P if stack 

overflow errors occur during 
assembly. Otherwise, not needed. 

2. Add to Section 2.7,9 Special Macro Operators and Forms 

TYPE Ti>u TYPE operator returns a byte that describes two characteristics 

cA ju argument; 1) the mode, and 2) whether it is Externa) or not. 
V*.« atqunient to TYPE may be any expression (string, numeric, 
iMiica]). If the expression is invalid, TYPE returns zero. 

Tftaj t'yic that is returned is configured as fellows: 

T.he> tower two bin are the mode. If the lower two btts are: 

the made is Absolute 

1 the mode is Program Relative 

2 the mooe is Data Relative 

3 Uc mode is Common Relative 

The high bit (QOH) is the External bit. If the high bit is on, the 
expression contains an External. If the high bit is off, the expression 
>s ioca: inot External). 

The Defined bit »s 20H. This bit is on if the expression is locally 
cyfineri, and :i is off if the expression is unoefined or external. !f 
ne.i'vr bit is on, the expression is invalid. 

TYPE is usually used inside macros, where an argument tyi>e may 
nml to be tested to make a decision regarding program flaw. Tor 
•iMiimple: 

rrxi MACRO X 
LOCAL Z 
7 srr TYPE X 

r 7 ... 



